home *** CD-ROM | disk | FTP | other *** search
/ 3D World 48 / 3D World CD Interactive Issue 48 (3DWi48) (2003).iso / pc / Resources / Next Limit / RealFlow / NL_C4D_OSX.sit / README_SD_NOW.txt < prev    next >
Text File  |  2003-05-22  |  7KB  |  173 lines
  1. Next Limit SD Exporter 2.0 for Cinema4D 7.303 and 8.xxx OSX
  2. ===========================================================
  3.  
  4. This plugin is not valid for versions of Cinema4D prior to 7.303.
  5.  
  6. =========================================================================
  7. Functionality, behavior and appearance are subject to changes. 
  8. Send issues to info@nextlimit.com (CC: bubinga@nextlimit.com)
  9. =========================================================================
  10.  
  11. This plug-in for Cinema4D, saves animated scene data to 
  12. a file, which can be read into RealFlow and/or RealWave.
  13.  
  14. Controls
  15. ========
  16.  
  17. Objects List
  18. There are three columns in this list: two check boxes and text
  19. "Sv" : save the object
  20. "Vt" : save vertex information for each frame .With this checkbox unchecked, 
  21. only position, rotation, scale and pivot are saved. This is useful when the object 
  22. doesn't contain any other displacement plug-in that could change the relative vertex 
  23. position. In other cases if you want to get the object deformation in RealFlow, the 
  24. vertex info button should be checked. Bear in mind that, for every frame, all the 
  25. object's vertices will be saved and the file size will increase accordingly.
  26.  
  27. Objects: object name, according to the internal Cinema hierarchy
  28.  
  29. Save All: save all objects in the list
  30. Save None: clear all Sv check boxes
  31. Vertex All: save vertex info for all objects
  32. Vertex None: clear all Vt check boxes
  33.  
  34. Rescan Scene: rebuild the object list
  35.  
  36. Check box "Rebuild Objects Each Frame (Slower)"
  37. Refresh vertex info for each frame for all objects that need to. Important 
  38. for certain types of deformers and HyperNURBS.
  39.  
  40. Messages: progress messages.
  41.  
  42. First Frame and Last Frame: first and last frames to save.
  43.  
  44. Save SD: Go! While saving, the button reads STOP, to stop saving. 
  45.  
  46. Outfile: self explanatory.
  47.  
  48.  
  49. Procedure
  50. =========
  51. To export your scene to RealFlow, follow these steps:
  52.  
  53. 1. Open the plug-in window, found under the Plugins menu. 
  54.  
  55. 2. Select the objects to export, including or not vertex information.
  56.  
  57. 3. Set the first and last frames to export.
  58.  
  59. 4. Click Outfile button and choose a filename for saving.
  60.  
  61. 5. Press SaveSD. 
  62.  
  63. 6. In the Message list some messages will appear when saving data.
  64.  
  65.  
  66. IMPORTANT (and we mean it!)
  67. =========
  68.  
  69. This plugin exposes the internal object hierarchy of Cinema4D, so some 
  70. understanding of it is necessary before saving objects. 
  71. Cinema4D generates hidden polygonal objects from some objects in the scene 
  72. (i.e: cubes, spheres, surfaces, boolean operators, arrays..), and if 
  73. deformers (bend, twist...) have been applied to those objects and are active, 
  74. another hidden polygonal object is further made from those. The list of objects 
  75. that appears in the plugin window shows all these hidden (and not hidden) polygonal 
  76. objects. 
  77. For example, get an array (2 copies) of pyramids, and a bend deformer under Pyramid.
  78. The resulting hierarchy for Cinema is:
  79.  
  80.     Array (visible)
  81.       |--->Array (hidden)
  82.       |      |    
  83.       |      |->Pyramid.1 (hidden)
  84.       |      |      |->Pyramid.1 (hidden, polygonal, not deformed by bend)
  85.       |      |             |->Pyramid.1 (hidden, polygonal, deformed by bend)
  86.       |      |->Pyramid.2 (hidden)
  87.       |      |      |->Pyramid.2 (hidden, polygonal, not deformed by bend)
  88.       |      |             |->Pyramid.2 (hidden, polygonal, deformed by bend)
  89.       |      |->Pyramid.3 (hidden)
  90.       |             |->Pyramid.3 (hidden, polygonal, not deformed by bend)
  91.       |                    |->Pyramid.3 (hidden, polygonal, deformed by bend)
  92.       |--->Pyramid (visible)
  93.                |->Bend (visible)
  94.  
  95. The objects that will show up in the plugin will be:
  96. (1)    Array->Array->Pyramid.1->Pyramid.1
  97. (2)    Array->Array->Pyramid.2->Pyramid.2        (These are not deformed)
  98. (3)    Array->Array->Pyramid.3->Pyramid.3
  99. and 
  100. (4)    Array->Array->Pyramid.1->Pyramid.1->Pyramid.1
  101. (5)    Array->Array->Pyramid.2->Pyramid.2->Pyramid.2   (These are deformed)
  102. (6)    Array->Array->Pyramid.3->Pyramid.3->Pyramid.3
  103.  
  104. To save the array of deformed pyramids, one would check the Sv checkboxes of (4), (5) and (6),
  105. AND their Vt checkbox (they are deformed). If the deformation parameters
  106. of the deformer were also animated, "Rebuild Objects Each Frame (Slower)" would also need 
  107. to be checked.
  108.  
  109. Another example, a boolean with a cylinder and a sphere:
  110. We would have:
  111.  
  112.     Boole (visible)
  113.       |--->Sphere-Cylinder (hidden) (the name would change depending on the operation)
  114.       |      |->Sphere (hidden, polygonal, cut by cylinder)
  115.       |      |->Cylinder (hidden, polygonal, , cut by sphere)
  116.       |--->Sphere (visible)
  117.       |     |->Sphere (hidden, polygonal, full sphere)
  118.       |--->Cylinder(visible)
  119.             |->Cylinder (hidden, polygonal, full cylinder)
  120. We would see:
  121. (1)  Boole->Sphere-Cylinder->Sphere   (These two are the intersected objects)
  122. (2)  Boole->Sphere-Cylinder->Cylinder
  123. (3)  Boole->Sphere->Sphere           (These two are the full objects)
  124. (4)  Boole->Sphere->Cylinder
  125.  
  126. To save the sphere cut by a cylinder, we would check Sv for objs (1) and (2)
  127.  
  128. Another one:
  129. A cube animated with two bones:
  130.  
  131.     Cube (visible)
  132.      |--->Cube (Hidden, not deformed)
  133.      |      |->Cube (hidden, deformed by the bones)     
  134.      |--->Bone (visible)
  135.            |->Bone.1 (visible)
  136.  
  137. We would see:
  138. (1) Cube->Cube       (not deformed)
  139. (2) Cube->Cube->Cube  (deformed)
  140.  
  141. To save the animated deformed object, check its Sv and Vt checkboxes AND "Rebuild 
  142. Objects Each Frame (Slower)"
  143.  
  144. There are lots and lots of generator objects and deformers in Cinema4D. To cover each one
  145. would require a fair amount of space. Try and experiment saving each type of object, and if 
  146. you discover a bug, please, tell us.
  147.  
  148.  
  149. Hints and tips
  150. ==============
  151.  
  152. -With the plugin window open, if an object of the hierarchy is deleted or added, you will 
  153. have to close and re-open the plugin window to reflect the changes or press the Rescan Scene 
  154. button.
  155.  
  156. -With the plugin window open, if a new document is loaded, it is necessary to press Rescan Scene 
  157. to load the new object hierarchy.
  158.  
  159. -To save correct data, only objects that have a CONSTANT number of vertices and faces 
  160. throughout the animation are allowed. Booleans with animated intersections must be avoided. 
  161.  
  162. -To save properly an object deformed by a Shatter deformer if the Strength 
  163. parameter is animated, this parameter must be always >0, i.e., from 1 to 100, because the number 
  164. of vertices change from 0 Strength to 1 Strength.
  165.  
  166. -Save ONLY objets with constant number of vertices and faces.
  167.  
  168. -"Rebuild Objects.." and Vt checkboxes are very useful to get animated deformations exported correctly.
  169.  
  170.  
  171.  
  172. The Next Limit Team.
  173.